Manager: Window Manager


Carbon supports the Window Manager. Be aware, however, that if you use custom window definition procedures (also known as WDEFs), you must compile them as PowerPC-native code. In addition:

* Your application must use the functions defined by the Window Manager whenever it creates and disposes of Window Manager data structures. For example, instead of directly creating and disposing of window records, applications must call such Window Manager functions as GetNewCWindow and DisposeWindow.

* You must revise your application so that it accesses Window Manager data structures only through accessor functions.

* You are encouraged to adopt the standard Mac OS 8 window definition procedures in your application. Applications that use the standard Mac OS 8 window definition procedures inherit the Mac OS 8 human interface appearance. Applications that use custom window definition procedures work correctly, but because custom definition procedures invoke their own drawing routines, Mac OS 8 can't draw these applications with the current appearance.

Supported  AreFloatingWindowsVisible

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  BeginUpdate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  BeginWindowProxyDrag

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  BringToFront

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CalcVis

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CalcVisBehind

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  CallDeskHookProc

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  CallWindowDefProc

Supported  ChangeWindowAttributes

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ChangeWindowPropertyAttributes

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CheckUpdate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ClipAbove

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CloneWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  CloseWindow

The CloseWindow function is not supported because developers do not allocate their own memory for windows in Carbon. Use the DisposeWindow function to remove a window instead. Not available in Carbon.

Supported  CollapseAllWindows

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CollapseWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ConstrainWindowToScreen

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  CopyWindowAlternateTitle

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  CopyWindowTitleAsCFString

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  CreateCustomWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  CreateNewWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  CreateStandardWindowMenu

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  CreateWindowFromCollection

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  CreateWindowFromResource

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  DebugInvertVisRegion

Supported  DebugPrintWindow

Supported  DebugPrintWindowList

Unsupported  DeskHookProcPtr

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  DisableSingleDocumentMode

Unsupported  DisposeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  DisposeWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DisposeWindowDefUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DisposeWindowPaintUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DragGrayRgn

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  draggrayrgn

Use DragGrayRgn instead. Not available in Carbon.

Not Recommended  DragTheRgn

Use DragGrayRgn instead. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DragWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  dragwindow

Use DragWindow instead. Not available in Carbon.

Supported  DrawGrowIcon

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  DrawNew

Use ReshapeCustomWindow. Not available in Carbon.

Supported  EnableSingleDocumentMode

Supported  EndUpdate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  EndWindowProxyDrag

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  FindWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  findwindow

Use FindWindow instead. Not available in Carbon.

Supported  FindWindowOfClass

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  FrontNonFloatingWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  FrontWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  GetAuxWin

Remove application reliance on AuxWinRec data structures; in the future, the information in these structures may be invalid or unavailable to applications. Not available in Carbon.

Unsupported  GetCWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in Carbon.

Supported  GetFrontWindowOfClass

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetGrayRgn

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetNewCWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetNewWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetNextWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetNextWindowOfClass

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetSheetWindowParent

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  GetWindowAttributes

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowBounds

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowClass

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowContentColor

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowContentPattern

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  GetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  GetWindowFeatures

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowFromPort

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  GetWindowGoAwayFlag

Use GetWindowAttributes instead.

Supported  GetWindowGreatestAreaDevice

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  GetWindowGreatestDevice

Supported  GetWindowIdealUserState

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowKind

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowList

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowModality

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  GetWindowOwnerCount

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowPic

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowPort

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowPortBounds

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowProperty

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowPropertyAttributes

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowPropertySize

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowProxyAlias

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowProxyFSSpec

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowProxyIcon

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowRegion

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowRetainCount

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Unsupported  GetWindowSpareFlag

Use GetWindowAttributes instead.

Supported  GetWindowStandardState

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowStructureWidths

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  GetWindowUserState

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWindowWidgetHilite

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  GetWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in Carbon.

Supported  GetWRefCon

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetWTitle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  getwtitle

Use GetWTitle instead. Not available in Carbon.

Supported  GetWVariant

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GrowWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  growwindow

Use GrowWindow instead. Not available in Carbon.

Supported  HideFloatingWindows

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  HideSheetWindow

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  HideWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  HiliteWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  HiliteWindowFrameForDrag

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  InitFloatingWindows

There is no need to initialize this Window Manager functionality because the shared library is loaded as needed. Not available in Carbon.

Unsupported  InitWindows

InitWindows is not supported in Carbon. There is no need to initialize the Window Manager because the shared library is loaded as needed. Not available in Carbon.

Supported  InstallWindowContentPaintProc

Available in Carbon 1.0.2 and later when running Mac OS 9, or later.

Unsupported  InvalRect

Calls InvalWindowRect, which takes a window pointer as an additional parameter.

Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Unsupported  InvalRgn

Calls InvalWindowRgn, which takes a window pointer as an additional parameter. Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Supported  InvalWindowRect

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  InvalWindowRgn

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  InvokeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  InvokeWindowDefUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  InvokeWindowPaintUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  IsSingleDocumentModeEnabled

Supported  IsValidWindowPtr

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  IsWindowCollapsable

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  IsWindowCollapsed

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  IsWindowHilited

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  IsWindowInStandardState

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  IsWindowModified

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  IsWindowPathSelectClick

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  IsWindowUpdatePending

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  IsWindowVisible

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  MoveWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  MoveWindowStructure

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Modified  NewCWindow

In Carbon, you cannot pass your own storage in to the wStorage parameter. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  newcwindow

Use NewCWindow instead. Not available in Carbon.

Unsupported  NewDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Modified  NewWindow

In Carbon, you cannot pass your own storage in to the wStorage parameter.

In Carbon, NewWindow is functionally equivalent to the NewCWindow, in that NewWindow returns a color window instead of a monochrome window. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  newwindow

Use NewCWindow instead. Not available in Carbon.

Supported  NewWindowDefUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  NewWindowPaintUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  PaintBehind

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  PaintOne

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  PinRect

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  pinrect

Use PinRect instead. Not available in Carbon.

Supported  RegisterWindowDefinition

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  ReleaseWindow

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  RemoveWindowProperty

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  RemoveWindowProxy

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  RepositionWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  ReshapeCustomWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ResizeWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  RetainWindow

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Unsupported  SaveOld

Use ReshapeCustomWindow. Not available in Carbon.

Supported  ScrollWindowRect

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ScrollWindowRegion

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SelectWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SendBehind

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  SetDeskCPat

You can no longer affect the desktop under Carbon, so SetDeskCPat has been removed from Carbon. There is no replacement function. Not available in Carbon.

Supported  SetPortWindowPort

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  SetWinColor

Use SetWindowContentColor. Not available in Carbon.

Supported  SetWindowAlternateTitle

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Unsupported  SetWindowAttributes

Use ChangeWindowAttributes instead.

Supported  SetWindowBounds

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowClass

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  SetWindowContentColor

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowContentPattern

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Unsupported  SetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  SetWindowIdealUserState

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowKind

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetWindowModality

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  SetWindowModified

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowPic

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetWindowProperty

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowProxyAlias

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowProxyCreatorAndType

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowProxyFSSpec

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowProxyIcon

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  SetWindowStandardState

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetWindowTitleWithCFString

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  SetWindowUserState

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetWRefCon

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetWTitle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  setwtitle

Use SetWTitle instead. Not available in Carbon.

Supported  ShowFloatingWindows

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  ShowHide

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ShowSheetWindow

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Supported  ShowWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SizeWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  StoreWindowIntoCollection

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  TrackBox

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  trackbox

Use TrackBox instead. Not available in Carbon.

Supported  TrackGoAway

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  trackgoaway

Use TrackGoAway instead. Not available in Carbon.

Supported  TrackWindowProxyDrag

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  TrackWindowProxyFromExistingDrag

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  TransitionWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  TransitionWindowAndParent

Available in Carbon 1.1 and later when running Mac OS 8.6 or later.

Unsupported  ValidRect

Calls ValidWindowRect, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Modified  ValidRgn

Calls ValidWindowRgn, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Supported  ValidWindowRect

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  ValidWindowRgn

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  WindowDefProcPtr

Supported  WindowPaintProcPtr

Supported  WindowPathSelect

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

Supported  ZoomWindow

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  ZoomWindowIdeal

Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 8/1/2000. Copyright © 1999, 2000 Apple Computer, Inc. All rights reserved.